home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / csver20.zip / CSVERIFY.DOC < prev    next >
Text File  |  1993-02-04  |  7KB  |  142 lines
  1.        (*****************************************************)
  2.        (* CSVerify 2.0   Written by Gary Bouchard           *)
  3.        (* SysOp - The Computer Store BBS                    *)
  4.        (* St. Augustine, Florida (904)794-0063              *)
  5.        (* Copyright(c) 1992....All Rights Reserved          *)
  6.        (* Released                 Modified                 *)
  7.        (*****************************************************)
  8.  
  9.                      Installation of CSVerify
  10.  
  11. Create a directory to keep CSVerify in. There is a sample PCB bat file
  12. included that you can modify to your liking. Go into PCBsetup, and go to the
  13. MainBoard setup. Move the cursor to Doors.dat and press F2 to edit it. Make an
  14. entry for CSVerify, the security required to access it, then answer YES to
  15. logon, and YES to USERS.SYS.
  16.  
  17. USERS.SYS is important, because once a caller is verified thru the phone
  18. number given, the information is then written back to the USERS.SYS file and
  19. in turn PCBoard updates the users record from the USERS.SYS file.
  20.  
  21. Example;
  22. ╔══════════════════════════════════════════════════════════════════════════════
  23. ║                        Edit User Record (Long Form)     Record   125 of   125
  24. ║
  25. ║  Name        : PETER FONDA                 Last DIR Listing : 07-18-92
  26. ║  City        : ST. AUGUSTINE, FLORIDA      Last Date On     : 07-18-92
  27. ║  B/D Phone   : 904 999-9999 <<Updated     .Last Time On     : 19:12
  28. ║  H/V Phone   : 904 794-0063                Elapsed Time On  :     5
  29. ║  Password    : TEST                        Number Times On  :     1
  30. ║  Security    :  60  <<Updated Info.        Number Uploads   :     0
  31. ║  Expert      : N                           Number Downloads :     0
  32. ║  Protocol    : Z                           Daily Download   :          0
  33. ║  Page Len    : 23                          Total Upload     :          0
  34. ║  Reg Ex Date : 03-18-93                    Total Download   :          0
  35. ║  Expired Sec :  30                         Messages Read    :          0
  36. ║  Msg Clear   : Y                           Messages Left    :          0
  37. ║  Last in     :     0                       Editor Default   : A
  38. ║  Delete User : N
  39. ║
  40. ║  Comment1    : IBM
  41. ║  Comment2    : XXX XXX-XXXX was/not verified. <<Updated information
  42. ║
  43. ╚══ 08:49:16 ═══ 07-19-92 ══════ F1 ═ help ════ caps: OFF  num: ON   ins: OFF ═
  44.  
  45. The B/D phone number is optionally replaced with the telephone number the user
  46. entered into the program to be verified. This phone number is formatted to
  47. PCBoard specs, and in the SysOp Comment Field (Comment 2) the text "XXX
  48. XXX-XXXX was/not verified." is optionally inserted.
  49.  
  50. In this way you can tell which users in your users file have been verified by
  51. this program.
  52.  
  53. The text files included are used by my board, and can be modified to your
  54. liking. They have the capability, as you will see, to expand the standard
  55. PCBoard @xxxx@ macros, and color macros.
  56.  
  57.  
  58. Activities performed by the program are logged into your PCBoard Callers
  59. log. If you have multiple nodes, the program will make the entry into the
  60. proper caller# log.
  61.  
  62. Make sure that the information in the CSVerify.cnf file is correct for your
  63. BBS. The lines are fully commented in the configuration file for ease of
  64. modification. Call me if you have any trouble, or want something added.
  65.  
  66. I do not include the area code or any prefixes in the dialing string unless
  67. you either specify the allowable callback areas, or allow long distance
  68. callback. If you do not include this information the program WILL NOT CALL
  69. LONG DISTANCE. I ask the user if the number is long distance if the area code
  70. or exchange entered does not match what you specify in the CSVerify.cnf or
  71. exchange file(s).
  72.  
  73. If the number entered is deemed long distance, the program will adjust the
  74. users security level to that you have specified in the config file the user
  75. will be notified of that fact, and returned to PCB.
  76.  
  77. The security level you give to the long distance user is entirely up to you...
  78. I usually give an intermediate level until I determine if the user is a
  79. visiting SysOp, then upgrade him/her later.
  80.  
  81. If you allow long distance calls, you can configure the program to verify the
  82. number, then once the user is upgraded, tells the user that he/she is now
  83. verified, and tells them to call back for access. The program will them drop
  84. carrier and recycle.
  85.  
  86. There is a trashcan type of file included in the zip file you can use as a
  87. sample. You can add numbers to this list that you want rejected should they be
  88. entered by a user. Each time a user is successfully verified, the phone number
  89. used by the caller is added to this list.
  90.  
  91. The SysOp has the ability to alter the users expiration date once he/she is
  92. verified. There is a variable in the configuration file called EXPIRED. This
  93. can be set anywhere from 1 day to whenever, and is adjusted by the day. If you
  94. set EXPIRED=730 then the users expiration date would be set for two years from
  95. the date of registration. On the other hand if you set it for 1 day, it would
  96. expire 1 day after registration. Leaving it blank defaults to 365 days or 1
  97. year, which is pretty much standard.
  98.  
  99. The program will support the 13 digit international phone number now. To
  100. activate this feature, just add the keyword "INTERNATIONAL" to line 23
  101. of the configuration file, and it will accept the long dialing string.
  102. What is not available here is support for local exchange/area code
  103. verification. The program accepts the number without spaces for 13
  104. digits, and is not broken into its separate parts. The program will
  105. however check for a match in the trashcan.csv file before continuing.
  106.  
  107. Let me know if you need something else added to the program or datafile.
  108.  
  109. CSVerify has the ability to perform CALLBACK only type calls. Once a user has
  110. registered, and been successfully verified, you can set the program up to just
  111. disconnect the caller, and have CSV call the user back. Once connected, the
  112. usr is returned to PCBoard. In order to accomplish this task, you must in some
  113. way send an environment variable to CSV. CSV looks for the environment
  114. variable "PCBDOOR" when it is executed. If PCBDOOR is set to "CB" that the
  115. program will do a CALLBACK only, rather than a registration verification.
  116.  
  117. You can do this one of two ways, and I'll give you a couple of examples
  118. here;
  119.  
  120. 1) From the PCBoard menu, I have the letters "CSV" which open the callback
  121.    door. If I type CSV<space>CB, then when CSV executes, it is in callback
  122.    only mode. If I type CSV by itself, then the program is in
  123.    registration/verification mode. Typing the "CB" after the CSV command
  124.    places the "CB" into the environment variable PCBDOOR, and CSV will pick it
  125.    up.
  126.  
  127. 2) You can create a separate batch file for PCB to execute for callbacks which
  128.    would contain a line like "SET PCBDOOR=CB". You would then call the CSV
  129.    program as documented. At the end of the batch file you place the command
  130.    "SET PCBDOOR=" which would clear the environment variable for you when it
  131.    was finished.
  132.  
  133. By the Way:
  134.  
  135. I am awful at writing documentation.<g> If there is something missing from the
  136. documentation that you do not understand, please contact my BBS at the above
  137. number for clarification.
  138.  
  139. I use the History file as an addendum to the documentation, and there is a lot
  140. of information contained in the file, so please pay attention to what is in
  141. there, ok?
  142.